Java™ Plug-in HTML Converter
para instalação em Linux

Leia a documentação a seguir para instalar o Java™ Plug-in HTML Converter a partir do CD.

Você leu o contrato de licenciamento do Java™ Plug-in HTML Converter ?


O Java™ Plug-in HTML Converter converte um arquivo contendo applets para um formato que usa o Java™ Plug-in. Para usar o HTML Converter, siga as instruções abaixo.

Começando a usar o HTML Converter

Inicie o Converter

  1. Copie o diretório converter deste CD, que está localizado no diretório software-lin no nível raiz deste CD-ROM, para seu disco rígido usando sua ferramenta gráfica ou de linha de comando favorita.

  2. Use CD para mudar para o diretório para o qual você moveu o diretório converter.

  3. Use CD para mudar para o diretório converter\classes.

  4. Inicie o HTML Converter com este comando:

    java -classpath . HTMLConverter


Usando o Graphical HTML Converter

1. Inicie o HTML Converter

Inicie a interface gráfica com um dos métodos acima. Para obter as instruções sobre como usar o HTML Converter diretamente a partir da linha de comando, consulte "Usando a linha de comando para executar o Converter".

2. Selecione os arquivos a converter

Escolha "Browse..." para selecionar a pasta em uma caixa de diálogo. Depois de selecionar uma pasta, você pode escolher arquivos específicos a serem convertidos, especificando padrões de procura na caixa "Matching File Names". Você pode usar um * como coringa. Cada padrão deve ser separado por uma vírgula.

Exemplo: digitar *.html,*.htm vai fazer com que todos os arquivos que terminam com .html e .htm sejam convertidos.

Para converter todos os arquivos correspondentes em subdiretórios aninhados, selecione "Include Subfolders".

3. Escolha uma pasta para cópia de segurança

A pasta para cópia de segurança default tem o mesmo nome que a pasta que contém os documentos originais, com _BAK acrescentado a ele.

Exemplo: se o caminho para o documento original é C:\html\applet.html, a pasta de cópia de segurança é C:\html_BAK.

Se você quiser selecionar uma pasta diferente para a cópia de segurança, digite o novo caminho na caixa "Backup Files to Folder" ou escolha "Browse..." para selecionar a nova pasta a partir de uma caixa de diálogo.

4. Gere um arquivo de log

O arquivo de log do HTML Converter contém informações básicas relacionadas ao processo de conversão, incluindo a data de conversão, o número de arquivos processados e o número de applets encontrados.

Se você quiser que um arquivo de log seja gerado, selecione "Generate Log File" da janela Edit -> Options. Digite o caminho na caixa "Specify Location for Log File" ou escolha "Browse..." para escolher uma pasta.

5. Escolha um gabarito de conversão

O arquivo de gabarito determina como o HTML de seu arquivo é alterado para usar o Java Plug-in. Se nenhum gabarito for escolhido, será usado um gabarito default. O gabarito default irá produzir arquivos HTML convertidos que funcionarão com o IE e o Netscape.

Se você quiser usar um gabarito diferente, selecione-o do menu escamoteável rotulado com "Template File". Se você escolher "Other Template", você pode escolher um arquivo personalizado que será usado como gabarito. Este arquivo deve ser um gabarito.

6. Converta os documentos

Clique o botão "Convert..." para iniciar o processo de conversão. Uma caixa de diálogo vai mostrar o arquivo que está sendo processado, o número de arquivos processados, o número de applets encontrados e o número de erros encontrados.

7. Saindo do HTML Converter

Quando a conversão estiver completa, o botão na caixa de diálogo mudará de "Cancel" para "Done". Clique em "Done" para fechar a caixa de diálogo.

Selecione "Exit" do menu "File" para fechar o Java™ Plug-in HTML Converter ou repita as etapas acima para escolher um outro conjunto de arquivos para converter.


Usando a linha de comando para executar o Converter

O HTML Converter agora tem suporte para uma interface de linha de comando.

java -classpath . HTMLConverter [ filespecs ] [-simulate]
[-options1 value1 [-option2 value2 [...]]]

filespecs
Lista de especificações de arquivo e coringas (*) delimitados por espaços. (*.html *.htm)
options
source
Caminho para os arquivos originais (c:\htmldocs). Default: <userdir>
Se o caminho for relativo, é considerado relativo para o diretório no qual o HTMLConverter foi iniciado.
backup
Caminho para gravar arquivos de segurança. Default: <userdir>/<source>_bak
Se o caminho for relativo, é considerado relativo para o diretório no qual o HTMLConverter foi iniciado.
subdirs
Opção para processar arquivos em subdiretórios. Default: FALSE
template
Nome do arquivo de gabarito. Default: default.tpl
default.tpl é padrão (IE e Navigator) somente para Windows e Solaris.
Use o default se você não tiver certeza.
log
Caminho e nome do arquivo de log. Default <userdir>/convert.log
progress
Exibe progresso na saída-padrão enquanto converte. Default: true
simulate
Exibe dados específicos da conversão, sem converter.
Você receberá uma lista detalhada de informações específicas sobre a conversão. Use esta opção se você estiver inseguro.

Se somente java HTMLConverter for digitado na linha de comando (sem especificações de arquivos ou opções), a interface gráfica do Converter será iniciada.


Gabaritos

O arquivo de gabarito determina como os applets convertidos são codificados na página HTML. O gabarito é simplesmente um arquivo de texto que contém marcas que representam as partes do applet original. Adicionando, removendo ou rearranjando as marcas em um arquivo de gabarito, você pode alterar a saída do arquivo convertido.

Marcas suportadas:

$OriginalApplet$
Esta marca é usada para substituir o texto completo do applet original.
$AppletAttributes$
Esta marca é usada para substituir todos os atributos do applet (code, codebase, width, height, etc.).
$ObjectAttributes$
Esta marca é usada para substituir todos os atributos exigidos pela marca object.
$EmbedAttributes$
Esta marca é usada para substituir todos os atributos exigidos pela marca embed.
$AppletParams$
Esta marca é usada para substituir todas as marcas <param ...> do applet.
$ObjectParams$
Esta marca é usada para substituir todas as marcas <param...> exigidas pela marca object.
$EmbedParams$
Esta marca é usada para substituir todas as marcas <param...> exigidas pela marca embed no formato NOME=VALOR.
$AlternateHTML$
Esta marca é usada para substituir o texto na área de "No support for applets" do applet original.
$CabFileLocation$
Este é o URL do arquivo compactado que deve ser usado em cada gabarito voltado para o IE.
$NSFileLocation$
Este é o URL do plugin do Netscape que deve ser usado em cada gabarito voltado para Netscape.

default.tpl
Este é o gabarito default para o Converter. A página convertida pode ser usada no IE e no Navigator, no Windows 95 ou no Windows NT, para invocar o Java™ Plug-in.

<OBJECT
  classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"
$ObjectAttributes$ codebase="$CabFileLocation$">
$ObjectParams$
<PARAM NAME="type"
        VALUE="application/x-java-applet;version=1.3">
$AppletParams$<COMMENT>
<EMBED type="application/x-java-applet;version=1.3"
        $EmbedAttributes$
$EmbedParams$ pluginspage="$NSFileLocation$">
<NOEMBED></COMMENT>
$AlternateHTML$
          </NOEMBED></EMBED>
</OBJECT>

ieonly.tpl
As páginas convertidas com este gabarito podem ser usadas para invocar o Java™ Plug-in somente no IE, no Windows 95 ou no Windows NT.

<OBJECT
  classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"
$ObjectAttributes$ codebase="$CabFileLocation$">
$ObjectParams$
<PARAM NAME="type"
        VALUE="application/x-java-applet;version=1.3">
$AppletParams$
$AlternateHTML$
</OBJECT>

nsonly.tpl
As páginas convertidas com este gabarito podem ser usadas para invocar o Java™ Plug-in somente no Navigator, no Windows 95 ou no Windows NT.

<EMBED type="application/x-java-applet;version=1.3"
      $EmbedAttributes$
$EmbedParams$ pluginspage="$NSFileLocation$"><NOEMBED>
$AlternateHTML$
</NOEMBED></EMBED>

extend.tpl
As páginas convertidas com este gabarito podem ser usadas em qualquer navegador ou plataforma. Se o navegador ´for o IE ou o Navigator, no Windows 95 ou no Windows NT, o Java™ Plug-in será invocado. Caso contrário, utiliza-se a MVJ (máquina virtual Java) default do navegador.

<SCRIPT LANGUAGE="JavaScript"><!--
    var _info = navigator.userAgent; var _ns = false;
    var _ie = (_info.indexOf("MSIE") > 0
            && _info.indexOf("Win") > 0 &&
_info.indexOf("Windows 3.1") < 0);
//--></SCRIPT>
<COMMENT><SCRIPT LANGUAGE="JavaScript1.1"><!--
    var _ns = (navigator.appName.indexOf("Netscape") >= 0 &&
((_info.indexOf("Win") > 0 && _info.indexOf("Win16") < 0 &&
java.lang.System.getProperty("os.version").indexOf("3.5")
            < 0) ||
_info.indexOf("Sun") > 0));
//--></SCRIPT></COMMENT>

<SCRIPT LANGUAGE="JavaScript"><!--
    if (_ie == true) document.writeln('<OBJECT
classid="clsid:8AD9C840-044E-11D1-B3E9-00805F499D93"
      $ObjectAttributes$
codebase="$CabFileLocation$"><NOEMBED><XMP>');
    else if (_ns == true) document.writeln('<EMBED
type="application/x-java-applet;version=1.3"
      $EmbedAttributes$
$EmbedParams$ pluginspage="$NSFileLocation$">
      <NOEMBED><XMP>');
//--></SCRIPT>
<APPLET $AppletAttributes$></XMP>
$ObjectParams$
<PARAM NAME="type"
      VALUE="application/x-java-applet;version=1.3">
$AppletParams$
</APPLET>
$AlternateHTML$
</NOEMBED></EMBED></OBJECT>



Usando o HTML Converter em outras plataformas

Se você quiser executar o Converter em uma plataforma diferente do Solaris, do Microsoft Windows ou do Linux, você precisará usar o instalador Pure Java. Uma vez feita a instalação, mude de diretório para a pasta de instalação e configure classpath para

./:./HTMLConverter.jar:./templates

Nota: .'s e /'s são específicos para UNIX. Assegure-se de usar os separadores de caminho e arquivo apropriados para sua plataforma. Depois, inicie o HTML Converter invocando a classe principal, HTMLConverter.

Como funciona o HTML Converter

O código HTML que não faz parte de um applet é transferido do arquivo original para um arquivo temporário. Quando é encontrada uma marca <APPLET>, o Converter analisa o applet até a primeira marca </APPLET> e intercala os dados do applet com o gabarito. Isto é então anexado ao arquivo temporário. Para obter mais informações sobre gabaritos, veja Gabaritos.

Se isto terminar sem erros, o arquivo HTML original é movido para a pasta de cópia de segurança e o arquivo temporário (convertido) é renomeado com o nome do arquivo original. Seus arquivos originais nunca são removidos do disco.

Note que o Converter efetivamente converte os arquivos no lugar em que estão. Depois que você executou o Converter, seus arquivos estão prontos para usar o Java™ Plug-in.


Informações adicionais sobre o Java™ Plug-in HTML Converter

Para obter as informações mais recentes sobre o Java™ Plug-in HTML Converter, visite...
http://java.sun.com/products/plugin/

Voltar para Instalação do Software